.. _cmmLtcReadLatch:

cmmLtcReadLatch
========================
------------------------

SYNOPSIS
```````````

.. code-block:: none

    VT_I4 cmmLtcReadLatch(
        [in] VT_I4 Axis, [in] VT_I4 Counter, 
        [out] VT_PR8 LatchedPos
        )

     
DESCRIPTION
```````````````

- 지정한 축의 현재 래치된 카운트값을 반환합니다. 이때 반환되는 위치 값의 단위는 논리적 거리 단위가 적용됩니다.



PARAMETER
```````````

- Axis: 축번호. 축번호는 상수값으로 [cmX1] 부터 0 번째 축을 기준 축으로 임의의 축을 설정할 수 있습니다.

\

- Counter : 읽을 래치 카운터를 지정합니다. 이 값은 다음과 같습니다.

.. csv-table::
  :widths: 10 85
  :header-rows: 1
  :stub-columns: 0

  Value, Meaning
  0, 명령위치 카운터(Command position counter)
  1, 실제위치 카운터(Feedback position counter)
  2, Deviation 또는 펄스 출력 속도. 
  3, General Counter




RETURN VALUE
`````````````
.. csv-table::
  :widths: 10 85
  :header-rows: 1
  :stub-columns: 0

  Value, Meaning
  음수, 수행 실패
  cmERR_NONE, 수행 성공


EXAMPLE
```````````

.. code-block:: c++
 :linenos:
 :emphasize-lines: 5

 C/C++

 #include “Cmmsdk.h”
 #include “CmmsdkDef.h”

 // 0 번 축의 래치 카운트를 Feedback position counter 로 설정하고 래치된 카운트 값을 반환합니다.
 long nLtcCounter = cmCNT_FEED;
 double fLatchedPos = 0.0f;
 cmmLtcReadLatched(cmX1, nLtcCounter, &nLatchedPos );



.. code-block:: none
 :linenos:

 Visual Basic

 ‘0 번 축의 래치 카운트를 Feedback position counter 로 설정하고 래치된 카운트 값을 반환합니다.
 Dim nLtcCounter As Long
 Dim fLatchedPos As Double

 nLtcCounter = cmCNT_FEED
 fLatchedPos = 0#

 Call cmmLtcReadLatched(cmX1, nLtcCounter, nLatchedPos )



.. code-block:: none
 :linenos:

 Delphi
 
 // 0 번 축의 래치 카운트를 Feedback position counter 로 설정하고 래치된 카운트 값을 반환합니다.
 var
    nLtcCounter : LongInt;
    fLatchedPos : Double;
 begin

    nLtcCounter := cmCNT_FEED;
 fLatchedPos := 0;
    cmmLtcReadLatch(cmX1, nLtcCounter, @fLatchedPos );
 end;